home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / texts / rdhtml2g.lha / RDHTML2AG.readme < prev   
Text File  |  1996-04-16  |  3KB  |  96 lines
  1. Short:    Converts HTML documents into several AmigaGuide files. RexxDoesHTML2AmigaGuide
  2. Author:   rmike@sbox.tu-graz.ac.at
  3. Uploader: rmike@sbox.tu-graz.ac.at
  4. Type:     docs/hyper
  5.  
  6. RDHTML2AG - Rexx Does HTML 2 AmigaGuide
  7.  
  8.     Written 1996 by Michael Ranner
  9.  
  10.         EMail: rmike@focus.co.at
  11.         Homepage: http://www.sbox.tu-graz.ac.at/home/rmike
  12.  
  13.     Version 1.1
  14.  
  15.     RDHTML2AG is Public Domain.
  16.  
  17.         You may use it, modify it and distribute it all over the world!
  18.         RDHTML2AG may not be used in commercial software!
  19.  
  20. Motivation
  21.  
  22.     There was no converter, that can convert HTML documents into AmigaGuide files.
  23.  
  24. Introduction
  25.  
  26.     Better than nothing, RDHTML2AG can convert a subset of HTML 2 terms:
  27.  
  28.     <H1> to <H6> ... rendered as described in the HTML 2 Guide
  29.     <I> ... as italic, @{I}
  30.     <B> ... as bold, @{B}
  31.     <BR> ... as line break
  32.     <P> ... as new paragraph
  33.     <HR> ... as 80 underlined spaces
  34.     <UL> ... as indent parapraph (only with V39 AmigaGuide, means Kick 3.0), @{LINDENT}
  35.     <OL> ... same as <UL>! Sorry, no numbering of <LI> items.
  36.     <LI> ... as '* ' for <UL> and <OL>
  37.     <A HREF=...> ... as node to another AmigaGuide file
  38.     <IMG SRC=...> ... as [Image] or ['ALT text'] and Guide links to display these Images.
  39.     <PRE> ... as preformatted
  40.     <XMP> and <LISTING> ... same as <PRE> but only </XMP> or </LISTING> term will be recognized.
  41.     <ADDRESS>, <CITE>, <EM> and <VAR> ... as italic
  42.     <STRONG> ... as bold
  43.     <BLOCKQUOTE> ... as new paragraph and italic
  44.  
  45.     Naturelemente all </...> to the above terms will be recognized :-)
  46.  
  47.     Replacement of & and so? Sorry, at the moment only & < > and " will be converted
  48.     to '&', '<', '>' and '"'.
  49.     
  50.     Forms will be not converted ;-)
  51.  
  52.     Hyperlinks through the Net like http://... and so, doesn't work ;-), but will be displayed!
  53.  
  54. Installation
  55.  
  56.     copy RDHTML2AG to Rexx:
  57.  
  58. Usage
  59.  
  60.     Change in the directory, where you want to convert the HTML documents.
  61.  
  62.     rx RDHTML2AG your.html
  63.  
  64.         converts your guide in several files (each node, one file)
  65.  
  66.     rx RDAG2HTML ?
  67.  
  68.         prints the argument template Source/A.
  69.  
  70. Future
  71.  
  72.     I have to write this stuff in C to speed it up. ARexx is fine but speed is
  73.     better :-)
  74.  
  75. Bugreport
  76.  
  77.     For minor bugs, you can eventually change the code by your self, but in any way,
  78.     if you have found an bug, please report to rmike@sbox.tu-graz.ac.at or
  79.     mranner@focus.co.at.
  80.  
  81. Suggestions
  82.  
  83.     Suggestions are welcome and should be send to rmike@sbox.tu-graz.ac.at or
  84.     mranner@focus.co.at.
  85.  
  86. Disclaimer
  87.  
  88.     THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING 
  89.     ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  90.     THE AUTHOR BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  91.         ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
  92.     IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
  93.         OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  94.  
  95.     Use it at your own risk!
  96.